#AI Skills 技能功能指南

AI Skills 是通过编写 SKILL.md 文件定义可复用的工作流和指令集。PIGX 平台将这一能力集成到企业级管理中，支持团队统一上传、管理和使用 AI 技能。

#整体流程

flowchart LR
    A[PIGX AI 平台] --> B[上传 Skill 包]
    B --> C[Claude Code CLI]
    C --> D[加载 SKILL.md]
    D --> E[LLM 执行任务]
    E --> F[流式返回结果]

#什么是 Skills

Skills（技能）是 Claude Code 的扩展机制，本质上是一组打包好的 Markdown 指令文件。每个 Skill 包含一个 SKILL.md 主文件和可选的辅助文件，定义了 Claude 在特定场景下应该如何工作。

简单来说：

• SKILL.md = 给 AI 的标准操作流程（SOP）
• /skill-name = 一键触发这套流程的快捷命令

Skills 的核心优势在于可复用：写一次指令，团队所有人都可以通过同一个命令获得一致的输出质量。

#Skills 的两种调用方式

#Skill 包结构

一个标准的 Skill 包是一个 ZIP 压缩文件，解压后的目录结构如下：

my-skill/
├── SKILL.md              # 必需 - 主指令文件
├── references/           # 可选 - 参考文档
│   ├── api-guide.md
│   └── examples.md
├── scripts/              # 可选 - 辅助脚本
│   └── helper.sh
└── templates/            # 可选 - 模板文件
    └── output.md

#平台使用指南

#上传技能

在 PIGX 管理平台中，进入 AI Skills 页面，点击「上传技能」按钮。

上传要求：

• 文件格式：.zip 压缩包
• 文件大小：不超过 10MB
• 必须包含 SKILL.md 文件

系统会自动解析 ZIP 包中的 SKILL.md，提取 YAML 元数据并创建技能记录，辅助文件会单独存储。

#管理技能

上传成功后，技能以卡片形式展示在列表中。每个卡片显示：

• 技能名称和版本号
• 启用/禁用状态
• 描述信息
• 使用的模型和代理类型
• 是否支持用户调用（/skill-name）

支持的操作：

#测试使用

#humanizer-zh 技能

技能作用：去除文本中的 AI 生成痕迹，使其听起来更自然、更像人类书写。基于维基百科的"AI 写作特征"综合指南，检测并修复夸大的象征意义、宣传性语言、模糊的归因、破折号过度使用、AI 词汇、否定式排比、过多的连接性短语等模式。

点击下载 humanizer-zh.zip

#技能调用

输入文本：

针对我在昨日工作中出现的失误，我在此向大家郑重致歉。由于我个人在工作中的疏忽，给团队的推进和相关安排带来了不便，对此我深感抱歉，也已进行了认真反思。

#特别说明：超级模式

超级模式会通过平台 SDK 连接本地的 Claude Code CLI 运行环境，并由 Claude Code 按标准 Skill 机制加载和执行 SKILL.md 文件。

这种模式的优势在于，Skill 本身就是 Claude 最早提出并实现并原生支持的能力，因此在执行过程中能够更完整地继承其运行特性，包括技能加载机制、沙箱约束以及命令行侧的相关能力支持。对于需要依赖标准 Skill 工作流的场景，超级模式通常具备更好的兼容性和执行一致性。

#前置条件

使用 AI Skills 功能前，需要完成以下准备工作：

1. 安装 Claude Code CLI：参考 Claude Code 正确的安装方式 完成安装和供应商配置
2. 开通 AI 套餐：确保已开通包含 Skills 功能的 AI 服务套餐
3. 配置模型供应商：通过 CC-Switch 或环境变量配置好可用的 API 中转服务